Initiate Pull API
Initiate Pull API is used by the Program User (Program Maker or Program Checker) to initiate the transaction.
Method: POST
{{URL}}/VisaDirect/rpc/VisaDirectService/InitiatePull
Example
Request Parameters
| Parameter | Description |
|---|---|
| businessId Mandatory | String Business identifier for the transaction. Sample Value – ‘FD’ |
| amount Mandatory | number Transaction amount. |
| recipientAccountNumber Mandatory | String PL or EPL account number of the recipient. |
| purposeOfPayment Optional | String Description or purpose of the payment. Sample Value – ‘Repayment’ |
| endToEndID Mandatory | String Unique transaction identifier. |
| transactionCurrencyCode Mandatory | String Currency code in ISO 4217. Sample Value – ‘USD’ |
| allowed_embedding_origin Optional | String Domain for iframe embedding. Sample Value – ‘test.com’ |
Body
{
"businessId": "FD",
"amount": 6,
"recipientAccountNumber": "4060320000000127",
"purposeOfPayment": "Repayment",
"endToEndID": "324581",
"transactionCurrencyCode": "USD",
"allowed_embedding_origin": "test.com"
}
Response: 200
Response Parameters
| Parameter | Description |
|---|---|
| sessionId | String Unique identifier for the secure checkout session. This ID must be linked to the IFrame page along with the respective End to End ID, where the Card Details are to be entered by the Card Holder. |
| expiresAt | String Session expiration timestamp in UTC. Format includes fractional seconds and offset Sample Value – ‘2025-11-25 10:35:55.40084648 +0000 UTC’ |
{
"sessionId": "f9dac737-caad-432b-a386-e23e32e8636d",
"expiresAt": "2025-11-25 10:35:55.40084648 +0000 UTC m=+9870.408319820"
}